Skip to content

fix(project-onboard): use correct brain_path key in Phase 1#27

Merged
joedanz merged 1 commit intomasterfrom
fix/project-onboard-brain-path
Apr 17, 2026
Merged

fix(project-onboard): use correct brain_path key in Phase 1#27
joedanz merged 1 commit intomasterfrom
fix/project-onboard-brain-path

Conversation

@joedanz
Copy link
Copy Markdown
Owner

@joedanz joedanz commented Apr 17, 2026

Summary

  • Phase 1 of project-onboard was looking for $PBRAIN_BRAIN_ROOT and the brain_root key in ~/.pbrain/config.json, but pbrain init writes brain_path (env var $PBRAIN_BRAIN_PATH). The config-file lookup always missed on correctly-initialized installs, so the skill fell through to the filesystem scan or user prompt every time.
  • Replace with the real key/env var, add a concrete jq command so agents don't invent parsing logic, and leave an explicit "do NOT look for brain_root" guardrail to prevent regression from stale docs.

Test plan

  • grep -r "brain_root\|PBRAIN_BRAIN_ROOT" skills/ returns only the intentional guardrail comment
  • bun test test/skills-conformance.test.ts test/resolver.test.ts → 140/140 pass
  • Smoke-test on a real install: run project-onboard in a repo and confirm Phase 1 resolves via the config-file path instead of falling through to the filesystem scan

Phase 1 told agents to look for `$PBRAIN_BRAIN_ROOT` and the `brain_root`
key in `~/.pbrain/config.json`, but `pbrain init` writes `brain_path`
(env var `$PBRAIN_BRAIN_PATH`). The config-file lookup always missed on
correctly initialized installs, forcing every invocation to fall through
to the filesystem scan or user prompt.

Replace with the real key/env var, add a concrete `jq` command so agents
don't invent parsing logic, and leave an explicit "do NOT look for
brain_root" note to prevent regression from stale docs in training data.
@joedanz joedanz merged commit d823278 into master Apr 17, 2026
3 checks passed
@joedanz joedanz deleted the fix/project-onboard-brain-path branch April 17, 2026 16:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant